home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / hypertxt / msdos / hydos10 / append < prev    next >
Text File  |  1991-04-23  |  3KB  |  60 lines
  1.                                    APPEND
  2.           Locate files other than .COM .EXE .BAT by a search path
  3.                               See also <PATH>
  4.  
  5. Locates files outside of current directory that have extensions other
  6. than .COM, .EXE, and .BAT.
  7.  
  8. COMMAND TYPE: Internal and External     VERSION: 3.3 and up
  9.  
  10. USE:
  11. (FIRST USE ONLY)
  12.     APPEND [/X][/E]
  13. or (to specify directories explicitly)
  14.     APPEND d:path[;[d:]path ...]
  15.  
  16. (SUBSEQUENT USES)
  17.      APPEND d:path[;[d:]path ...]
  18. or (to delete appended paths)
  19.      APPEND [;]
  20. or (to modify action with certain commands - see below)
  21.      APPEND [path] [/X:[OFF|ON]] [/path:[OFF|ON]]
  22.  
  23. d:path specifies the path to search. Paths cannot be specified the
  24.    first time the APPEND command is loaded if either /X or /E are also
  25.    specified.
  26. ;  to separate the APPEND paths or to request the list to be reset to
  27.    null if the semi-colon is the only parameter.
  28. /E is used to keep the APPEND paths in the DOS environment, similar to
  29.    the <PATH> command.  APPEND searches the environment on each call to
  30.    find the path. If the /E is not specified, the path string is held
  31.    within the APPEND command.  The paths are not stored in the
  32.    environment and can only be viewed or changed by using the APPEND
  33.    command.
  34. /X to process SEARCH FIRST, FIND FIRST, and EXEC functions.  Commands
  35.    such as <COMP> and <DIR> use the SEARCH FIRST functions to search for
  36.    files.  Commands such as <BACKUP>, <RESTORE>, and <TREE> use the FIND
  37.    FIRST function to locate files.  DOS uses the EXEC function any
  38.    time a command is entered.
  39.    The following functions are processed by APPEND with or without /X:
  40.    OPEN FILE, OPEN HANDLE, GET FILE SIZE
  41.  
  42. NOTE: If APPEND has been loaded with /X, before using BACKUP or
  43. RESTORE, APPEND must be issued using null (;).
  44.  
  45. MSDOS 4.x  The extra parameters /x:off, /x:on are available to toggle
  46.    the setting of this function.  Individual paths may be disabled or
  47.    enabled from APPEND processing with the /path:on, /path:off
  48.    parameters.
  49.  
  50. NOTE: /X and /E can only be specified on the first invocation of the
  51.    APPEND command. APPEND must be used before <ASSIGN> if you intend to
  52.    use the <ASSIGN> command.
  53.  
  54. The main use of APPEND is to allow applications to access auxiliary
  55. files without needing run from the directory where those files are
  56. stored. The command processor finds the application itself (.COM, .EXE
  57. or .BAT) via the <PATH> command.  The APPEND paths then allow the
  58. application to locate other files (such as dictionary or configuration
  59. files).
  60.